<!DOCTYPE html>
<html lang="zh-CN" class="no-js">
<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width">
	<meta name="keywords" content="GitBlog,kts168的博客">
	<meta name="description" content="一篇GitBlog就是一个markdown文件，GitBlog使用解析markdown文件为html展示在网页上。所有的博客markdown文件必须放在posts文件夹里。后缀名只可以是xx.md或者xx.markdown。">

	<!--[if lt IE 9]>
	<script src="/theme/default/js/html5.js"></script>
	<![endif]-->
	<script>(function(html){html.className = html.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script>
	
	<title>编写GitBlog博客|kts168的博客</title>
	
	<link rel="stylesheet" href="/theme/default/css/genericons.css?ver=2.2" type="text/css" media="all" />
	<link rel="stylesheet" href="/theme/default/css/style.css?ver=2.2" type="text/css" media="all" />
	<link rel="stylesheet" href="/theme/default/css/markdown.css?ver=2.2" type="text/css" media="all" />
	<link rel="alternate" type="application/rss+xml" title="kts168的博客" href="/feed.xml" />
	<!--[if lt IE 9]>
	<link rel="stylesheet" href="/theme/default/css/ie.css?ver=2.2" type="text/css" media="all" />
	<![endif]-->
	<!--[if lt IE 8]>
	<link rel="stylesheet" href="/theme/default/css/ie7.css?ver=2.2" type="text/css" media="all" />
	<![endif]-->
	
	<script type="text/javascript" src="/theme/default/js/jquery/jquery.js?ver=2.2"></script>
	<script type="text/javascript" src="/theme/default/js/jquery/jquery-migrate.min.js?ver=2.2"></script>
	
	<script>
	var _hmt = _hmt || [];
	(function() {
	  var hm = document.createElement("script");
	  hm.src = "//hm.baidu.com/hm.js?732acc76ff6bd41343951a67cbfafe30";
	  var s = document.getElementsByTagName("script")[0]; 
	  s.parentNode.insertBefore(hm, s);
	})();
	</script>
	
</head>

<body>
<div id="page" class="hfeed site">
	<a class="skip-link screen-reader-text" href="#content">Skip to content</a>
	
	    <div id="sidebar" class="sidebar">
	<header id="masthead" class="site-header" role="banner">
		<div class="site-branding">
			<h1 class="site-title"><a href="/" rel="home">kts168的博客</a></h1>
				<p class="site-description">自豪地采用GitBlog</p>
				<button class="secondary-toggle">菜单和挂件</button>
		</div><!-- .site-branding -->
	</header><!-- .site-header -->
	<div id="secondary" class="secondary">
		<div id="widget-area" class="widget-area" role="complementary">
		
			<aside id="categories" class="widget widget_categories">
    <h2 class="widget-title">分类目录</h2>
    <ul>
                <li class="cat-item"><a href="/category/GitBlog.html" >GitBlog</a></li>
            </ul>
</aside>
		    <aside class="widget widget_archive">
    <h2 class="widget-title">文章归档</h2>
    <ul>
        <li><a href="/archive/201507.html">2015-07</a></li>
        </ul>
</aside>
		    <aside id="recent-posts" class="widget widget_recent_entries">
    <h2 class="widget-title">近期文章</h2>
    <ul>
        <li><a href="/blog/install.html">GitBlog安装</a></li>
        <li><a href="/blog/struct.html">GitBlog目录结构</a></li>
        <li><a href="/blog/config.html">GitBlog配置</a></li>
        <li><a href="/blog/edit.html">编写GitBlog博客</a></li>
        <li><a href="/blog/other-func.html">GitBlog评论，订阅，统计等功能</a></li>
        </ul>
</aside>
		    <aside id="tag_cloud" class="widget widget_tag_cloud">
    <h2 class="widget-title">标签</h2>
    <div class="tagcloud">
        <a href="/tags/GitBlog.html" title="GitBlog" >GitBlog</a>
        </div>
</aside>
		    <aside id="text" class="widget widget_text">
    <h2 class="widget-title">简介</h2>	
    <div class="textwidget">
    	<p>GitBlog是一个简单易用的Markdown博客系统，这是我的第一个GitBlog博客</p>
    </div>
</aside>
	    </div><!-- .widget-area -->
    </div><!-- .secondary -->
</div><!-- .sidebar -->  
	    <div id="content" class="site-content">
    <div id="primary" class="content-area">
        <main id="main" class="site-main" role="main">
        
            <article class="post hentry">
<header class="entry-header">
    <h1 class="entry-title">编写GitBlog博客</h1>
</header><!-- .entry-header -->
<div class="entry-content">
<!--
author: jockchou
date: 2015-07-27
title: 编写GitBlog博客
tags: GitBlog
category: GitBlog
status: publish
summary: 一篇GitBlog就是一个markdown文件，GitBlog使用解析markdown文件为html展示在网页上。所有的博客markdown文件必须放在posts文件夹里。后缀名只可以是xx.md或者xx.markdown。
-->
<p>一篇GitBlog就是一个markdown文件，GitBlog使用解析markdown文件为html展示在网页上。所有的博客markdown文件必须放在<code>posts</code>文件夹里。后缀名只可以是<code>xx.md</code>或者<code>xx.markdown</code>。</p>
<p>注意: 2.2版本开始，所有markdown文件和图片统一放到<code>blog</code>文件夹中。<a href="/blog/gitblog/struct.html">查看gitblog目录结构说明</a>。</p>
<h2>发表一篇新博客</h2>
<p>在<code>posts</code>里新建文件<code>helloworld.md</code>，输入以下内容：</p>
<pre><code>&lt;!--
author: jockchou
date: 2015-07-30
title: Hello World!
tags: GitBlog
category: GitBlog
status: publish
summary: 你好！GitBlog
--&gt;

你好！GitBlog

GitBlog是一个简单易用的Markdown博客系统，它不需要数据库，没有管理后台功能，更新博客只需要添加你写好的Markdown文件即可。
</code></pre>
<p>文件里头部的注释用来定义博客的属性，这是一个规定的写法，必须放在文件的头部，每个属性独占一行。再次访问首页，就能看到这篇新发的博客了。如果没显示，请清除<code>app/cache</code>文件夹下的所有缓存文件试试看。</p>
<pre><code>&lt;!--
这里定义博客属性
--&gt;</code></pre>
<p><em>注意：markdown文件须采用utf8编码</em>，如果出现乱码，请修改编码为utf8。</p>
<h2>博客属性定义</h2>
<p>GitBlog目前针对博客定义了以下属性：</p>
<ul>
<li>author: 博客作者名称  </li>
<li>date: 博客时间，用于页面显示，通常来说你不需要填写这个字段，默认就是创建日期</li>
<li>title: 博客标题  </li>
<li>tags: 博客里的标签，多个用逗号或空格分隔  </li>
<li>category: 博客分类，多个用逗号或空格分隔  </li>
<li>status: 博客状态，<code>draft</code>表示草稿，GitBlog解析时会忽略草稿；<code>publish</code>表示发表状态，默认为publish  </li>
<li>summary: 博客摘要信息  </li>
</ul>
<p>以上所有信息都是独占一行，暂不支持写在多行。</p>
<h2>2.1版本的新特性</h2>
<p>Gitblog的2.1版本针对博客的属性定义进行了一些优化。新增了两个可选属性</p>
<ul>
<li>images:博客的图片集，这里可以定义博客用到的图片的地址</li>
<li>head: 作者的头像地址</li>
</ul>
<p>以上两个属性是可选的，主要是针对一些主题展示用的。</p>
<p>自动提取title，summary，images属性。Gitblog2.1一个重要的功能，如果用户没有定义头部属性，Gitblog会自动解析博客内容，从中提取属性。提取第一个H1作为title，提取所有图片作为images，自动识别摘要信息summary。也就是说你可以不手动定义这三个字段，Gitblog会自动根据上述规则识别，不过还是推荐手动填写。</p>
<h2>markdown路径与URL对应关系</h2>
<p>GitBlog中<code>posts</code>中的markdown文件可以放在子文件夹中。举个例子，假如你的<code>helloword.md</code>文件目录如下：</p>
<pre><code>posts/hello/helloword.md</code></pre>
<p>你在浏览器访问的对应地址应该是这样的：</p>
<pre><code>http://jockchou.gitblog.cn/blog/hello/helloworld.html</code></pre>
<p>GitBlog对<code>posts</code>中子文件夹的层级没有限制，但请尽量不要太深，一般2，3层就够了。如果你在本地编写博客，使用FTP工具上传markdown文件到<code>posts</code>目录，如果你熟悉使用Git，SVN类似工具，用它们来发表博客也是极好的。markdown文件的路径和文件名标识了博客的唯一性，改变路径或修改文件名将会导致博客的评论信息丢失。</p>
</div><!-- .entry-content --><footer class="entry-footer">
	    <span class="posted-on">
        <span class="screen-reader-text">Posted on </span>
        <time class="entry-date published">2015-07-27</time>
    </span>
		
	    <span class="byline">
        <span class="author vcard">
            <span class="screen-reader-text">Author </span>
            jockchou
        </span>
    </span>
        
        <span class="cat-links">
        <span class="screen-reader-text">Categories </span>
          
           <a href="/category/GitBlog.html" rel="category">GitBlog</a>
            </span>
        
    
        <span class="tags-links">
    	
        <span class="screen-reader-text">Tags </span>
          
           <a href="/tags/GitBlog.html" rel="tag">GitBlog</a>
            </span>
    </footer><!-- .entry-footer --></article><!-- #post-## -->            <div id="comments" class="comments-area">
	<div id="respond" class="comment-respond">
		<div id="disqus_thread"></div>
		<script>
		   var disqus_config = function () {
		   this.page.url = location.href;
		   this.page.identifier = '7474bc2dda2232ae537ccac26fb1d3fa';
		   };
		(function() {
			var d = document, s = d.createElement('script');
			s.src = '//demo-site.disqus.com/embed.js';
			s.setAttribute('data-timestamp', +new Date());
			(d.head || d.body).appendChild(s);
		})();
		</script>
		<noscript>Please enable JavaScript to view the <a href="https://disqus.com/?ref_noscript">comments powered by Disqus.</a></noscript>
	</div><!-- #respond -->
</div><!-- .comments-area -->
            
        </main><!-- .site-main -->
    </div><!-- .content-area -->
</div><!-- .site-content -->	    <footer id="colophon" class="site-footer" role="contentinfo">
    <div class="site-info">
        <!--<a href="https://github.com/jockchou/gitblog">Proudly powered by Gitblog</a>-->
    </div><!-- .site-info -->
</footer><!-- .site-footer -->
	
</div><!-- .site -->
<script type="text/javascript" src="/theme/default/js/skip-link-focus-fix.js?ver=2.2"></script>
<script type="text/javascript">
/* <![CDATA[ */
var screenReaderText = {"expand":"<span class=\"screen-reader-text\">\u5c55\u5f00\u5b50\u83dc\u5355<\/span>","collapse":"<span class=\"screen-reader-text\">\u6298\u53e0\u5b50\u83dc\u5355<\/span>"};
/* ]]> */
</script>
<script type="text/javascript" src="/theme/default/js/functions.js?ver=2.2"></script>

<link rel="stylesheet" href="//cdn.bootcss.com/highlight.js/8.6/styles/github.min.css">
<script src="//cdn.bootcss.com/highlight.js/8.6/highlight.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>

<script type="text/x-mathjax-config">MathJax.Hub.Config({tex2jax: {inlineMath: [['$','$'], ['\\(','\\)']]}});</script>
<script type="text/javascript" src="//cdn.bootcss.com/mathjax/2.5.3/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>

</body>
</html>
